package com.ffggffgfv.backend.service;

import com.ffggffgfv.backend.dto.PageResult;
import com.ffggffgfv.backend.dto.UserLoginDTO;
import com.ffggffgfv.backend.dto.UserRegisterDTO;
import com.ffggffgfv.backend.dto.UserUpdateDTO;
import com.ffggffgfv.backend.entity.User;

import java.util.List;
import java.util.Map;

/**
 * 用户服务接口
 */
public interface UserService {

    /**
     * 查询所有用户
     *
     * @return 用户列表
     */
    List<User> findAll();

    /**
     * 用户注册
     *
     * @param userRegisterDTO 用户注册信息
     * @return 注册成功的用户对象
     */
    User register(UserRegisterDTO userRegisterDTO);

    /**
     * 检查用户名是否已存在
     *
     * @param username 用户名
     * @return 是否存在
     */
    boolean isUsernameExists(String username);

    /**
     * 检查手机号是否已存在
     *
     * @param phone 手机号
     * @return 是否存在
     */
    boolean isPhoneExists(String phone);

    /**
     * 检查邮箱是否已存在
     *
     * @param email 邮箱
     * @return 是否存在
     */
    boolean isEmailExists(String email);

    /**
     * 用户登录
     *
     * @param userLoginDTO 登录信息
     * @return 登录结果，包含用户信息和令牌
     */
    Map<String, Object> login(UserLoginDTO userLoginDTO);

    /**
     * 通过ID查询用户
     *
     * @param id 用户ID
     * @return 用户对象
     */
    User findById(Long id);

    /**
     * 获取用户详细信息
     *
     * @param id 用户ID
     * @return 用户详细信息
     */
    Map<String, Object> getUserDetail(Long id);

    /**
     * 更新用户信息
     *
     * @param id            用户ID
     * @param userUpdateDTO 用户更新信息
     * @return 更新后的用户对象，null表示更新失败
     */
    User updateUser(Long id, UserUpdateDTO userUpdateDTO);

    /**
     * 根据用户名查询用户
     *
     * @param username 用户名
     * @return 用户对象
     */
    User findByUsername(String username);

    /**
     * 根据手机号查询用户
     *
     * @param phone 手机号
     * @return 用户对象
     */
    User findByPhone(String phone);

    /**
     * 根据邮箱查询用户
     *
     * @param email 邮箱
     * @return 用户对象
     */
    User findByEmail(String email);

    /**
     * 分页查询用户列表
     *
     * @param username 用户名（可选）
     * @param pageNum  页码
     * @param pageSize 每页数量
     * @return 分页结果
     */
    PageResult<User> findByPage(String username, int pageNum, int pageSize);

    /**
     * 创建用户
     *
     * @param user 用户对象
     * @return 创建的用户对象
     */
    User createUser(User user);

    /**
     * 更新用户
     *
     * @param id   用户ID
     * @param user 用户对象
     * @return 更新后的用户对象
     */
    User updateUser(Long id, User user);

    /**
     * 更新用户密码
     *
     * @param id          用户ID
     * @param oldPassword 旧密码
     * @param newPassword 新密码
     * @return 是否成功
     */
    boolean updatePassword(Long id, String oldPassword, String newPassword);
}
